SP Speak String (voice; line) -> err

voice          string (63) specifys the voice you want to use.
line            string (255) is a string (max. length 255) which contains the
                                   text you want to be spoken.
err             integer       returns the error which occured. 
                                    A value of zero indicates no error occured. See 
                                    below for a list of possible errors.

Reads out the string you pass, using the specified voice, without returning to 4D until the line has been spoken.

The full string will be spoken and control will not return to 4D until the voice is finished. It is not possible to cancel. This function can still be used when the limit of speech channels opened by the SP Open Voice function has been reached.
An error will be returned if there is already a voice being produced, by Speech Pack or by any other software on the computer.

Examples:
  $err := SP Speak String ("*";"Look who is talking!")
  $err := SP Speak String ("Marvin";$line)
  $err := SP Speak String ("Marvin";[File 1]Name)

Possible errors:
        0  No Error
      -4  Speech Pack can not be used (Speech Mgr not available)
    -50  Parameter error (inside external, not necessarily the
            parameters you pass)
  -108  Not enough memory to load voice into memory

  -205  Bad channel, speaker volume is too low or Speech Pack disabled
  -241  Could not open another speech synthesizer channel
  -242  Voice synthesizer is not ready
  -244  Voice resource not found
  -247  Input text bad
-3000  Invalid SpeechChannel parameter, probably invalid reference
            number